package com.huashi.dealer.modular.business.region.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.huashi.dealer.commonEntity.Region;
import com.huashi.dealer.modular.business.region.param.RegionListItemVo;
import com.huashi.dealer.modular.business.region.param.RegionTreeVo;

import java.util.List;

/**
 * 地域Service接口
 *
 * @author 系统生成
 * @since 2025-01-27
 */
public interface RegionService extends IService<Region> {

    /**
     * 根据父级ID获取地域列表
     *
     * @param parentId 父级ID，0表示获取省份列表
     * @return 地域列表
     */
    List<RegionListItemVo> getRegionListByParentId(Long parentId);

    /**
     * 根据ID获取地域名称
     *
     * @param regionId 地域ID
     * @return 地域名称
     */
    String getRegionNameById(Long regionId);

    /**
     * 根据名称和父级ID获取地域ID
     *
     * @param regionName 地域名称
     * @param parentId   父级ID
     * @return 地域ID
     */
    Long getRegionIdByNameAndParent(String regionName, Long parentId);

    /**
     * 获取所有省份列表
     *
     * @return 省份列表
     */
    List<RegionListItemVo> getProvinces();

    /**
     * 获取指定省份下的城市列表
     *
     * @param provinceId 省份ID
     * @return 城市列表
     */
    List<RegionListItemVo> getCitiesByProvince(Long provinceId);

    /**
     * 获取指定城市下的区县列表
     *
     * @param cityId 城市ID
     * @return 区县列表
     */
    List<RegionListItemVo> getRegionsByCity(Long cityId);

    /**
     * 获取完整的省市区信息
     *
     * @param provinceId 省份ID
     * @param cityId     城市ID
     * @param regionId   区县ID
     * @return 省市区信息
     */
    String getFullRegionName(Long provinceId, Long cityId, Long regionId);

    /**
     * 获取完整的省市区树形结构数据
     *
     * @return 省市区树形结构数据
     */
    List<RegionTreeVo> getRegionTree();
}
